home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / ansi / grabb396.zip / GRTXT.DOC < prev    next >
Text File  |  1992-02-04  |  13KB  |  282 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                       GRTXT(tm)
  9.  
  10.                          (the GRABBER(tm) ASCII Text Subset)
  11.  
  12.                                      Version 0.6
  13.  
  14.                            -------------------------------
  15.  
  16.                            The ASCII Screen Capture Program
  17.                              for the IBM PC, XT, AT, PS/2
  18.                                    and Compatibles
  19.  
  20.                                     DOCUMENTATION
  21.                                    February 4, 1992
  22.  
  23.                                Copyright 1991, 1992 by
  24.                                    Gerald A. Monroe
  25.                                  All rights reserved.
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.           YOUR LICENSE TO USE THIS SOFTWARE
  33.           ----------------------------------
  34.  
  35.           GRTXT.EXE and this documentation are copyright 1991, 1992 by
  36.           Gerald A. Monroe.  All rights are reserved except those expressly
  37.           granted here.
  38.  
  39.           The GRTXT program and this documentation file are distributed as
  40.           part of the GRABBER(tm) screen capture package under the terms of
  41.           a shareware license that is fully set forth in the file GRABBER
  42.           .DOC.  (GRABBER.DOC is the reference manual for GRABBER.EXE, the
  43.           main program module in the package.)
  44.  
  45.           The shareware license terms in the GRABBER.DOC file are incorpo-
  46.           rated here by reference.  This license permits you to copy and
  47.           distribute the files GRTXT.EXE and GRTXT.DOC (this file) freely,
  48.           provided that:  these files are always distributed together with
  49.           each other and with the GRABBER.EXE and GRABBER.DOC files; none
  50.           of the files is modified in any way; and no fee, premium or
  51.           donation of any kind whatsoever is charged or requested for their
  52.           distribution except as permitted on the terms described in the
  53.           GRABBER.DOC file.
  54.  
  55.           Continued use of the GRTXT program for more than a 10-day trial
  56.           period requires you to register your use of the software with the
  57.           author.  For more information about the benefits of registration
  58.           and how to go about registering, please refer to the full licens-
  59.           ing and ordering information in the GRABBER.DOC file.
  60.  
  61.           GRTXT(tm)                 Documentation               Page 2 of 5
  62.  
  63.  
  64.  
  65.           ABOUT GRTXT.EXE -- GRABBER's "TEXT" VERSION
  66.           --------------------------------------------
  67.  
  68.           GRTXT is an alternative version of the GRABBER screen capture
  69.           program.  It is an especially valuable tool for users who need to
  70.           capture character-based text images from the video screen direct-
  71.           ly to plain ASCII text files on disk.
  72.  
  73.           While GRABBER can be used to capture both character-based text
  74.           screens as well as pixel-based graphic images to your disk in the
  75.           form of executable image files, GRTXT is designed to capture
  76.           character-based text screens exclusively.  GRTXT also differs
  77.           from GRABBER in that GRTXT captures your screens directly to
  78.           plain-ASCII text files, instead of to the .exe format.
  79.  
  80.           If your screen capture needs are mostly text-based, and you
  81.           require the ASCII format rather than the .exe format, then GRTXT
  82.           can be much more convenient to use than GRABBER.  GRTXT creates
  83.           ASCII text files that are ready to use immediately, without
  84.           having to be processed first by the GR2ASCII conversion utility
  85.           which accompanies GRABBER.
  86.  
  87.           GRTXT is installed and operated in much the same way as GRABBER,
  88.           and the two programs have a very similar look and feel.  For the
  89.           most part, this documentation for GRTXT covers only the aspects
  90.           of GRTXT which differ from GRABBER.  It is assumed here that you
  91.           have read the GRABBER documentation file (GRABBER.DOC) and become
  92.           familiar with that program's operation.
  93.  
  94.  
  95.           USING GRABBER and GRTXT SIMULTANEOUSLY
  96.           ---------------------------------------
  97.  
  98.           GRTXT is designed to be compatible with GRABBER.  Both programs
  99.           can be installed in memory at the same time.
  100.  
  101.           The default "hotkey" sequence for GRTXT is [Alt =].  That is, you
  102.           hold down the [Alt] key, press the equal sign key [=], then
  103.           release the [Alt] key.
  104.  
  105.           GRTXT is designed to capture character-based text images exclu-
  106.           sively.  If you press GRTXT's hotkey and hear a single low-
  107.           pitched tone on the computer speaker, this means that the video
  108.           screen is running in a pixel-based graphics mode, and GRTXT is
  109.           unable to capture the screen.
  110.  
  111.           GRTXT(tm)                 Documentation               Page 3 of 5
  112.  
  113.  
  114.  
  115.           MODIFYING THE GRTXT HOTKEY
  116.           ---------------------------
  117.  
  118.           GRTXT allows you to modify your hotkey sequence from the default
  119.           [Alt =] to practically any other key sequence you choose.  In
  120.           this respect, GRTXT is exactly like GRABBER.  There is no sepa-
  121.           rate documentation here which covers the procedure for changing
  122.           your GRTXT hotkey.  GRTXT uses the exact same hotkey procedures
  123.           as GRABBER.  You can read about these in the GRABBER.DOC manual,
  124.           at page 30 and at Appendices A and B.  (To view a list of valid
  125.           KEY= codes for GRTXT, use the command GRTXT KEY=?.  To view a
  126.           list of valid SHIFT= codes, enter GRTXT SHIFT=?.)
  127.  
  128.  
  129.  
  130.           GRTXT INSTALLATION OPTIONS
  131.           ---------------------------
  132.  
  133.           GRTXT accepts the following command-line switches.  Each of these
  134.           optional switches (except for the APPEND option) is also avail-
  135.           able in the GRABBER program.  For more complete details concern-
  136.           ing the purpose of these optional switches and how they work,
  137.           consult the section beginning on page 15 of your GRABBER documen-
  138.           tation which is headed "Grabber Installation Options."
  139.  
  140.  
  141.  
  142.           Option:   DEFAULTDRIVE
  143.  
  144.           Purpose:  Tells GRTXT to capture text screens to whatever drive
  145.                     and directory path is the current DOS default.  As with
  146.                     GRABBER, this switch can substitute for the drive/path
  147.                     parameter which is otherwise required to make GRTXT
  148.                     stay resident in memory.
  149.  
  150.  
  151.  
  152.           Option:   MOUSE  and  NOMOUSE
  153.  
  154.           Purpose:  To enable and disable, respectively, GRTXT's recogni-
  155.                     tion of the "mouse hotkey," which allows you to capture
  156.                     your text screens by holding down both the left and
  157.                     right mouse buttons for about two seconds.
  158.  
  159.           Please note:  The mouse hotkey function is available in the
  160.           GRABBER program as well as in GRTXT.  If you have installed both
  161.           programs in memory simultaneously, do not use the MOUSE switch to
  162.           enable the mouse hotkey with both programs.  Strange results are
  163.           almost guaranteed to occur, and it may even lock up your computer
  164.           when you use the mouse hotkey.  It is acceptable to use the MOUSE
  165.           switch with either GRTXT or GRABBER, but not both.
  166.  
  167.           GRTXT(tm)                 Documentation               Page 4 of 5
  168.  
  169.  
  170.  
  171.           Option:   UNLOAD
  172.  
  173.           Purpose:  Removes GRTXT from your computer's memory.  GRTXT
  174.                     cannot be removed from memory if, after you initially
  175.                     installed it, you loaded other memory-resident software
  176.                     which is activated by any of the same hardware or
  177.                     software interrupts which GRTXT uses.  If you are using
  178.                     GRTXT and GRABBER simultaneously, both programs can be
  179.                     removed from memory, but only in the reverse order in
  180.                     which they were initially installed.  In other words,
  181.                     "last in, first out."
  182.